home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / gnu / amiga / sipp.lha / sipp / README < prev    next >
Text File  |  1993-03-13  |  4KB  |  81 lines
  1. *******************************************************************
  2.              SIPP  --  3d rendering package
  3.  
  4.              Copyright  Equivalent Software HB   1992
  5.  
  6.              Authors:   Jonas Yngvesson   jonas-y@isy.liu.se
  7.                         Inge Wallin       ingwa@isy.liu.se
  8.                  _
  9.              Linkoping Institute of Technology
  10.              Sweden
  11. *******************************************************************
  12.  
  13. This is SIPP, the SImple Polygon Processor, version 3.0.  SIPP is a
  14. library for creating 3-dimensional scenes and rendering them using a
  15. scan-line z-buffer algorithm.  A scene is built up of objects which
  16. can be transformed with rotation, translation and scaling.  The
  17. objects form hierarchies where each object can have arbitrarily many
  18. subobjects and subsurfaces.  A surface is a number of connected
  19. polygons which are rendered with either Phong, Gouraud or flat
  20. shading.  An image can also be rendered as a line drawing of the
  21. polygon edges without any shading at all.
  22.  
  23. The library supports texture mapping with textures in up to
  24. 3-dimensions and automatic interpolation of texture coordinates.
  25. Simple anti-aliasing can be performed through oversampling.  A scene
  26. can be illuminated by an arbitrary number of light sources and a
  27. number of different lightsources are availiable.  The light from some
  28. of them are capable of casting shadows of objects.  A basic shading
  29. algorithm is provided with the library, but the user can also use his
  30. own shading algorithms for each surface to produce special effects.
  31. Objects can have varying degree of transparency, controlled by the
  32. shader.
  33.  
  34. It is possible to create several virtual cameras and use any of them
  35. as viewpoint for a particular rendering.
  36.  
  37. Images can be rendered directly onto a file in the Portable Pixmap
  38. format (ppm) (or, for line images, Portable Bitmap, pbm) or written
  39. using user-supplied functions.  This function can, for instance,
  40. write into a pixmap in memory or into a screen window or anything
  41. else.
  42.  
  43.  
  44. To view the images there are several programs which can display the
  45. ppm format.  If the X-window system is availiable we can recommend the
  46. programs xv and xloadimage.  Both are availiable by anonymous ftp from
  47. export.lcs.mit.edu (18.24.0.12) in the contrib directory, and probably
  48. from several other sites also.  The pbmplus package wich can convert
  49. the ppm format into a large number of other formats (GIF, TIFF, etc.)
  50. is also availiable by anonymous ftp from the same site.
  51.  
  52.  
  53. To install the library, the demonstration programs and the manuals,
  54. see the file INSTALL for details.
  55.  
  56.  
  57. The directory 'doc' contains standard UNIX man pages for quick
  58. reference, and also a complete "User's Guide" in texinfo format.  To
  59. make a typeset version of this manual you need the TeX typesetting
  60. system.  You can also create an online info-manual of this document,
  61. either with the program 'makeinfo' or in GNU-emacs with the command
  62. M-X texinfo-format-buffer.  Here also, see the file INSTALL for more
  63. details.
  64.  
  65.  
  66. If you have used SIPP before, you might notice a number of
  67. incompatibilities with version 2.0 and 2.1.  The file COMPATIBILITY
  68. describes what features are incompatible with the older versions and
  69. how you can compile your old programs with the new library.
  70.  
  71.  
  72. Please send any enhancements, bug reports and fixes to us.
  73. Especially, if you create nice new object types or interesting
  74. shaders, we would be grateful if you sent the C functions to us.  We
  75. could then compile a library of object functions and/or shaders and
  76. let other people share the benefits.
  77.  
  78. Linkoping 2 May 1992
  79.  
  80.                 enjoy! /Jonas & Inge
  81.